AppendMenuItemText

AppendMenuItemText
Header:	Menus.h		Carbon status:	Supported

Appends a menu item to a menu.

OSStatus AppendMenuItemText (
    MenuHandle menu, 
    ConstStr255Param inString
);

menu: A handle to the menu to which the item is to be appended.
inString: A Pascal string containing the text of the menu item to append. You can pass a string containing any characters, and these characters will be presented verbatim in the menu item.

function result: A result code.

DISCUSSION

The AppendMenuItemText function appends the menu item containing the specified string to a menu, without evaluating the string for metacharacters, as the pre–Mac OS 8.5 Menu Manager function AppendMenu does. You may wish to use AppendMenuItemText if you have a need to present non-alphanumeric characters in a menu item.

The appended menu item appears at the end of the menu as an enabled item. If you wish to place the menu item elsewhere than at the end of the menu you should use the function InsertMenuItemText.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MenusLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by MenusLib 8.5 and later.